home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / bbs_util / scid101.zip / SENTRY.DOC < prev    next >
Text File  |  1996-04-02  |  38KB  |  968 lines
  1.  
  2.  
  3.  
  4.  
  5.   ▄█████▄ ▄██████ ▄█████▄ ███████ ██████▄ ██   ██     ▄█████▄ ▐██▌ ██████▄ ██
  6.   ██▄▄▄▄  ██▄▄▄▄  ██   ██   ▐█▌   ██   ██ ██▄ ▄██ ▄▄▄ ██       ██  ██   ██ ██
  7.    ▀▀▀▀██ ██▀▀▀▀  ██   ██   ▐█▌   ██████   ▀███▀  ▀▀▀ ██       ██  ██   ██ ▀▀
  8.   ▀█████▀ ▀██████ ██   ██   ▐█▌   ██  ▀██   ▐█▌       ▀█████▀ ▐██▌ ██████▀ ██
  9.  
  10.  
  11.                B B S     C A L L E R - I D     I N T E R F A C E
  12.  
  13.                          VERSION 1.01 - First Release!
  14.  
  15.  
  16.  
  17.                      Copyright (c) 1996 by Jason Hendriks
  18.  
  19.                               ALL RIGHTS RESERVED
  20.  
  21.                        "Power Software for Lazy People"
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.      S E N T R Y - C I D                                                   1
  31.  
  32.      _______________________________________________________________________
  33.  
  34.  
  35.  
  36.      Sentry-CID (or "Scid" for short) is a Caller-ID-to-BBS interface.
  37.      Sentry-CID will read your mailer's logfile for caller-id information
  38.      and after extensive verification, automatically log the user onto the
  39.      bbs (MAXIMUS systems only).  SCID also provides information for on-line
  40.      validation of new users, eliminating the need for kludgy call-back
  41.      verifiers.  Sentry-CID is even smart enough to set your system clock!
  42.  
  43.      Skip ahead to section [3] to get set-up and running.  Please refer to
  44.      README.TXT for information on other utilities (bbs and otherwise) that
  45.      I have produced.  Please refer to REGISTER.TXT to find out how to
  46.      register SCID.
  47.  
  48.      Sentry/CID was tested on the original Caller-ID BadBoy, the SupraFAX
  49.      14.4 modem (with "J" ROMs) and is compatible with standard CID from the
  50.      United States and multi-page caller-id (hex data) used up here in the
  51.      Great White North.  SCID should work with all other Rockwell-based
  52.      caller-id capable modems, such as the ZyXel, and the new series of
  53.      caller-id modems offered by USR.
  54.  
  55.  
  56.  
  57.      ┌═════════════┐
  58.      │ [1.1] INDEX │
  59.      └═════════════┘
  60.      
  61.  
  62.                1 Sentry-CID
  63.                     1.1 Index
  64.                     1.2 Why Sentry-CID over some other?
  65.                     1.3 Features
  66.                     1.4 Requirements
  67.                     1.5 Contents of the Sentry-CID archive
  68.                     1.6 Registration
  69.  
  70.                2 Legal-Type Stuff
  71.                     2.1 Disclaimer
  72.                     2.2 Warranty
  73.                     2.3 License
  74.                     2.3 Copyrights
  75.  
  76.                3 Setup and Operation
  77.                     3.1 Configuring Your System
  78.                     3.2 Running Sentry-CID
  79.                     3.3 PhoneList
  80.                     3.4 Running Sentry-CID Validator
  81.                     3.5 Configuring Sentry-CID
  82.  
  83.                4 Maximus BBS
  84.                     4.1 Auto-Login
  85.                     4.2 OnLine Validation
  86.                     4.3 After Validation
  87.                     4.4 Ensuring the number is kept accurate
  88.  
  89.                5 Miscellaneous Information
  90.                     5.1 Release History
  91.                     5.2 Software Updates and Support
  92.                     5.3 Contacting the Author
  93.  
  94.  
  95.  
  96.      ┌═══════════════════════════════════════┐
  97.      │ [1.2] WHY SENTRY-CID OVER SOME OTHER? │
  98.      └═══════════════════════════════════════┘
  99.  
  100.      
  101.      I had been using another caller-id reading program (one of the best)
  102.      called MaxCID.  Unfortunately, after I sent in my $10 to register, I
  103.      never heard a peep out of the author and saw no new updates to the
  104.      program in response to my bug reports (I hereby promise to answer all
  105.      mail and fix all critical bugs).
  106.  
  107.      MaxCID was unable to recognize out-of-area callers (and we get a lot in
  108.      Kingston!), had a flaky "!"  autopassword toggle which would login 
  109.      users with multiple accounts if one of them used the toggle, crashed
  110.      when run in a full-screen OS/2 session and was forever logging on the
  111.      wrong user (VERY annoying) because it did not do enough verifying of
  112.      the CID information.  However, I am so confident with Sentry-CID, that
  113.      I even allow it to update the system clock when it feels it is
  114.      appropriate (great for users with computers that seem to gain about 
  115.      five minutes every day or for those who live in zones which abide by
  116.      daylight savings and can never remember when it is!).
  117.  
  118.  
  119.  
  120.      ┌════════════════┐
  121.      │ [1.3] FEATURES │
  122.      └════════════════┘
  123.  
  124.  
  125.      Here are the amazing features of Sentry-CID:
  126.  
  127.           GENERAL FEATURES
  128.              ■ DOS and OS/2 executables
  129.              ■ Can barricade private callers
  130.              ■ Can verify new callers using the validate caller mode
  131.                (useful with any bbs type)
  132.              ■ Can automatically synchronize the system clock with the
  133.                caller-id time
  134.  
  135.           PHONELIST
  136.              ■ Alias "+" matching on phone numbers for the same user who
  137.                calls from different phone numbers
  138.              ■ Drop carrier on twit users by matching "-" phone numbers
  139.              ■ Can login users found ONLY in phonelist for a truly private
  140.                system
  141.  
  142.           BBS USERFILE (MAXIMUS v3)
  143.              ■ Matches caller phone number with user in the bbs userfile and
  144.                logs them on
  145.              ■ Will prompt for password on user's request or if SCID is
  146.                unsure of the accuracy of the CID data
  147.              ■ ALWAYS prompts for a password when asstsysop or sysops login,
  148.                when multiple users of the same number call or when a user 
  149.                has not called in a long while
  150.              ■ logins the last caller when multiple users are flagged for 
  151.                the same phone number
  152.              ■ Can login users found ONLY in bbsfile for a truly
  153.                private system
  154.  
  155.           CID DATA VERIFICATION ENSURES NO LOGIN "MISTAKES"
  156.              ■ Makes sure CID time and mailer time do not differ by more 
  157.                than a certain amount in case of wonky CID data
  158.              ■ Makes sure mailer time and current time do not differ by more
  159.                than a certain amount in case the mailer has "forgotten" to
  160.                resume writing to the logfile after a system crash
  161.              ■ Makes sure CID time is within a certain distance from the end
  162.                of the logfile
  163.  
  164.  
  165.  
  166.      ┌════════════════════┐
  167.      │ [1.4] REQUIREMENTS │
  168.      └════════════════════┘
  169.      
  170.  
  171.           To run SCID, you need to have:
  172.              ■ a Caller-ID (or "Ident-a-Call" or "Caller-View") service
  173.                installed
  174.                on your phoneline by the phone company.  If yours is anything
  175.                like Ma Bell, there will probably be a set-up fee and monthly
  176.                service charge
  177.              ■ a modem capable of producing caller-id data (Supra, ZyXel, 
  178.                USR Sportster vi or USR Courier with the 1/23/96 firmware
  179.                flash)
  180.              ■ a mailer such as BinkleyTerm capable of recording the
  181.                caller-id data to a logfile ■ Maximus bbs (to utilize the
  182.                auto-login options)
  183.              ■ DOS or OS/2 v2.x
  184.  
  185.  
  186.  
  187.      ┌══════════════════════════════════════════┐
  188.      │ [1.5] CONTENTS OF THE SENTRY-CID ARCHIVE │
  189.      └══════════════════════════════════════════┘
  190.  
  191.  
  192.      FILE_ID.DIZ
  193.  
  194.           Description file for BBS file databases.
  195.  
  196.      REGISTER.TXT
  197.  
  198.           Registration form.
  199.  
  200.      SENTRY.DOC
  201.  
  202.           This file
  203.  
  204.      SENTRY.EXE
  205.  
  206.           Sentry-CID DOS 16-bit executable.
  207.  
  208.      SENTRYP.EXE
  209.  
  210.           Sentry-CID/2 OS/2 32-bit executable (Pentium-optimized).
  211.  
  212.      SENTRY.CFG
  213.  
  214.           Sample Sentry-CID configuration file.
  215.  
  216.      SENTRY.FON
  217.  
  218.           Sample alias-matching phonelist
  219.  
  220.      README.TXT
  221.  
  222.           Other software by me.
  223.  
  224.  
  225.  
  226.      ┌════════════════════┐
  227.      │ [1.6] REGISTRATION │
  228.      └════════════════════┘
  229.  
  230.  
  231.      As an incentive, registration of SCID enables the very useful
  232.      [AUTOSETTIME], [NOSYSOPLOGIN] and [LASTCALL_AGE] features, and also
  233.      makes Sentry-CID Validator functional.  Once registered, I will be much
  234.      more prone to listening to any suggestions and bug-reports you may 
  235.      have. I'm a student at Queen's University at Kingston, and I wrote this
  236.      program in my spare time.  Registration of SCID is only $10 which will
  237.      help pay for my taxi ride to the grocery store and back.  Thank-you in
  238.      advance!
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.      L E G A L - T Y P E    S T U F F                                      2
  246.  
  247.      _______________________________________________________________________
  248.  
  249.  
  250.  
  251.      ┌══════════════════┐
  252.      │ [2.1] DISCLAIMER │
  253.      └══════════════════┘
  254.  
  255.  
  256.      SCID is not programmed to format your harddrive, make long-distance    
  257.      calls to China with your modem while you are sleeping, or run amok in 
  258.      any other mischievous manner.  However, if you manage to reduce your   
  259.      your harddrive to egg salad as a result of using Sentry-CID, I will not
  260.      be held responsible for any damages incurred to your system, business 
  261.      or mental state (I wouldn't have any money to give you anyway!  I'm 
  262.      just a poor university student!)
  263.  
  264.      How come disclaimers always sound so grumpy?  Hey, things can always go
  265.      the OTHER way, you know.  Maybe you'll get lucky and SCID will be
  266.      responsible for a foxy-lady jumping out of your monitor or maybe
  267.      increase the speed of your CPU by 35%.  Funky chicken!
  268.  
  269.  
  270.  
  271.      ┌════════════════┐
  272.      │ [2.2] WARRANTY │
  273.      └════════════════┘
  274.  
  275.  
  276.      None!  I'm fairly confident that SCID will not fail when used correctly
  277.      as outlined in this document, but as a dear friend keeps reminding me,
  278.      "there is always one more bug".
  279.  
  280.  
  281.  
  282.      ┌═══════════════┐
  283.      │ [2.3] LICENCE │
  284.      └═══════════════┘
  285.  
  286.  
  287.      You are permitted to use SCID for 30 days.  Beyond that time, please
  288.      register!!  Any money you send will help further my education as my
  289.      rent and food budget seem to be getting smaller and smaller everyday.
  290.  
  291.  
  292.  
  293.      ┌══════════════════┐
  294.      │ [2.3] COPYRIGHTS │
  295.      └══════════════════┘
  296.  
  297.  
  298.           * MAXIMUS copyright(c) 1993, 1996 by Scott Dudley, Lanius Corp
  299.             [1:249/106]
  300.           * REMOTE ACCESS copyright(c) 1996 by somebody
  301.           * WATCOM is a trademark of WATCOM International Corp.
  302.           * MA BELL should be a trademark of Bell Canada Ltd.,
  303.             Northern Telecom
  304.           * 386i, 486i and PENTIUM are trademarks of Intel
  305.           * SUPRA copyright(c) 1996 by Supra Corp
  306.           * COURIER and SPORTSTER copyright(c) 1996 by US Robotics
  307.           * MAXCID copyright(c) 1994 by Louis LePage [1:246/66]
  308.           * CIDLOG copyright(c) 1992 by Steven L. Davis
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.      S E T U P    A N D    O P E R A T I O N                               3
  316.  
  317.      _______________________________________________________________________
  318.  
  319.  
  320.  
  321.      Sentry-CID will login, validate or barricade users after performing a
  322.      variety of checks on the CID data to determine it's accuracy.  If you
  323.      are running Maximus BBS and BinkleyTerm, you are in luck because so do
  324.      I and I have included easy examples to help you with the setup.  For
  325.      users of other software, it should be a simple matter of changing
  326.      pathnames and filenames to obtain the desired result.  At the present
  327.      time Auto-Login works only with Maximus BBS (v3).
  328.  
  329.  
  330.  
  331.      ┌═══════════════════════════════┐
  332.      │ [3.1] CONFIGURING YOUR SYSTEM │
  333.      └═══════════════════════════════┘
  334.  
  335.  
  336.      Caller-ID use must be enabled in your modem.  For modems with the
  337.      Rockwell chipset (like the Supra) the command is:
  338.  
  339.      #CID=1
  340.  
  341.      which should be placed in your mailer's modem init string.  Second, you
  342.      must tell your front-end mailer to answer on the second ring to allow
  343.      the caller-id information to be read by the modem.  For BinkleyTerm,
  344.      proper config commands would be:
  345.  
  346.                          ┌────────────────────────────┐
  347.                          │Answer             ATA|     │
  348.                          │Init               AT#CID=1|│
  349.                          │LogLevel           4        │
  350.                          │ModemRinging       Nmbr     │
  351.                          │ModemRinging       Mesg     │
  352.                          │RingTries          7        │
  353.                          └────────────────────────────┘
  354.  
  355.      or
  356.  
  357.                        ┌───────────────────────────────┐
  358.                        │Answer             ~~~`````ATA|│
  359.                        │Init               AT#CID=1|   │
  360.                        │ModemRinging       Ring        │
  361.                        │LogLevel           4           │
  362.                        │RingTries          7           │
  363.                        └───────────────────────────────┘
  364.  
  365.      Your modem will start sending results such as:
  366.  
  367.                       ┌─────────────────────────────────┐
  368.                       │DATE = 0401                      │
  369.                       │TIME = 2019                      │
  370.                       │NMBR = P                         │
  371.                       │NMBR = O                         │
  372.                       │MESG = 030735343233313230        │
  373.                       │MESG = 030B3136313335343233313230│
  374.                       │MESG = 06014C                    │
  375.                       └─────────────────────────────────┘
  376.  
  377.      or, if you live in the United States:
  378.  
  379.                               ┌──────────────────┐
  380.                               │DATE = 0401       │
  381.                               │TIME = 2019       │
  382.                               │NMBR = P          │
  383.                               │NMBR = O          │
  384.                               │NMBR = 5423120    │
  385.                               │NMBR = 16135423120│
  386.                               └──────────────────┘
  387.  
  388.      Ordinarily, your front-end mailer probably calls a batch file with a
  389.      set of parameters to pass to the bbs.  If that file is SPAWNBBS.BAT:
  390.  
  391.         ┌───────────────────────────────────────────────────────────────┐
  392.         │@echo off                                                      │
  393.         │\max\max.exe -s%1 -b%2 -p%3 -t%4   (or ra.exe -b%2 -p%3 -t%4 ?)│
  394.         └───────────────────────────────────────────────────────────────┘
  395.  
  396.      you must change it to first run SCID, then run the batch file created
  397.      by SCID:
  398.  
  399.                           ┌──────────────────────────┐
  400.                           │@echo off                 │
  401.                           │cd \scid                  │
  402.                           │sentry.exe                │
  403.                           │loadbbs.bat %1 %2 %3 %4 %5│
  404.                           └──────────────────────────┘
  405.  
  406.  
  407.  
  408.      ┌══════════════════════════┐
  409.      │ [3.2] RUNNING SENTRY-CID │
  410.      └══════════════════════════┘
  411.  
  412.  
  413.      The included SENTRY.CFG configuration file will need only minimal
  414.      changes of various path and filenames before running SENTRY.EXE (DOS)
  415.      or SENTRYP.EXE (OS/2).
  416.  
  417.      SCID takes two optional command line parameters.  Switch to the SCID
  418.      directory and run SENTRY -? (DOS) or SENTRYP -? (OS/2) for quick help.
  419.  
  420.      The -c<filename> command line option allows you to run SCID with a
  421.      different configuration file, which is handy for multi-node systems
  422.      which need to read different log files and write to different LOADBBS
  423.      batch files.  Sentry-CID will attempt to read the default configuration
  424.      file "SENTRY.CFG" if none is specified.
  425.  
  426.      The -d command line option tells SCID to run in debug mode.  This was
  427.      mainly for me while developing SCID and runs the program a tad slower.
  428.      But you may be interested to see just what kind of numbers SCID is
  429.      crunching through or may want to verify it's operation.
  430.  
  431.      The -v command line option tells SCID to run in verify mode.  More
  432.      information on verify modem is available in section [3.4].
  433.  
  434.      Sentry-CID returns the following errorlevels:
  435.         ■ 0: No operation, syntax displayed
  436.         ■ 1: User known, autologin, autopassword
  437.         ■ 2: User known, autologin, no autopassword
  438.         ■ 3: User known, no autologin, no autopassword
  439.         ■ 4: User unknown, no autologin, no autopassword
  440.         ■ 5: User unknown, user barred from bbs
  441.  
  442.  
  443.  
  444.      ┌═════════════════┐
  445.      │ [3.3] PHONELIST │
  446.      └═════════════════┘
  447.  
  448.  
  449.      If a user calls from more than one number, their other number(s) can be
  450.      "alias matched" to the phone number contained in the phonelist.  The
  451.      following:
  452.  
  453.      + 519-740-9592 5423120 (613)546-3844 ; calliing from the office
  454.  
  455.      would search for the phone number (519) 740-9592 in the userfile if any
  456.      calls were received from 542-3120 or (613) 546-3844.  It is important
  457.      to separate the "+" and subsequent phone numbers and to NOT have any
  458.      whitespace within the phone number.
  459.  
  460.      If [FORCELIST] was active, then only numbers listed in the phonelist,
  461.      or alias-matched in the phonelist, would be allowed to login.
  462.  
  463.      If there are twit users who you don't want calling your system, you can
  464.      include their phone numbers in the alias file as barricaded numbers.
  465.      Any phone numbers following a minus sign "-" in the phonelist will be
  466.      prevented from even entering the bbs.  The following:
  467.  
  468.      - 519-740-9592 613-546-3844 389-2127 ; go away Ian
  469.  
  470.      would prevent any callers from (519) 740-9592, (613) 546-3844 and
  471.      389-2127 from logging onto your system.
  472.  
  473.  
  474.  
  475.      ┌════════════════════════════════════┐
  476.      │ [3.4] RUNNING SENTRY-CID VALIDATOR │
  477.      └════════════════════════════════════┘
  478.  
  479.  
  480.      Sentry-CID Validator only works when SCID has been registered.  You
  481.      can run SCID and watch it compare numbers and report them as matched
  482.      or unmatched, but the semaphore file for the bbs will not be written
  483.      on successful matches (but I'm sure by now you're dying for your
  484.      registration key anyway!)
  485.  
  486.      The -d command line options tell Sentry-CID to run in validate mode.
  487.  
  488.      Sentry-CID Validator will compare the phone numbers in [OUTPUT] and
  489.      [BBSNUMBER] and if they match, will write a semaphore file
  490.      [OK_VALIDATION] which your bbs can read to determine if the user's
  491.      level should be upgraded.  See section [4.2] on an example of setting
  492.      up Maximus BBS to use this.
  493.  
  494.      Sentry-CID Validator returns the following errorlevels:
  495.         ■ 0: No operation, syntax displayed
  496.         ■ 1: User phone numbers verified
  497.         ■ 2: User phone numbers failed verification
  498.         ■ 3: Sentry is unregistered
  499.  
  500.  
  501.  
  502.      ┌══════════════════════════════┐
  503.      │ [3.5] CONFIGURING SENTRY-CID │
  504.      └══════════════════════════════┘
  505.  
  506.  
  507.      This is a detailed, alphabetical listing of commands in Sentry-CID's
  508.      config file.  Commands are not case-sensitive and semi-colons located
  509.      anywhere in the file are treated as comments.
  510.  
  511.  
  512.      Allow_Private
  513.  
  514.           Allow callers with blocked numbers to be passed to the bbs;
  515.           otherwise Sentry-CID will drop carrier (by NOT loading the bbs).
  516.           See [FORCELIST] and [FORCEUSERBBS].
  517.  
  518.      APW_KeyToggle <keys>
  519.  
  520.           This is the Maximus key (or keys) which must be set for the 
  521.           current user to have the [AUTO_PASSWORD] setting *toggled*. 
  522.           Thus, if you have [AUTO_PASSWORD] commented out (disabled) and
  523.           the user has the key set in [APW_KEYTOGGLE], then they will be
  524.           logged on as if [AUTO_PASSWORD] was enabled.  Vice versa,
  525.           [AUTO_PASSWORD] would be *disabled* for this user if it was
  526.           enabled in the configuration file.  I recommend using
  527.           key "L" (for login).  Valid keys range from 1-8 and A-X.
  528.  
  529.      Area_Code <area_code>
  530.  
  531.           Your region's phone area code.  See [COUNTRY_CODE].
  532.  
  533.      AutoLogin
  534.  
  535.           Determines whether the bbs is given the user's name for login. 
  536.           See [AUTOPASSWORD].
  537.  
  538.      AutoPassword
  539.  
  540.           Determines whether the bbs is given the user's name *and* password
  541.           for login (ie.  *completely* logged on) after Sentry-CID performs
  542.           all it's time and user status checks, or if the user is prompted
  543.           for their password.  This command is disabled if [AUTOLOGIN] is
  544.           disabled.  This command is toggled by the key in [APW_KEYTOGGLE].
  545.  
  546.      AutoSetTime
  547.  
  548.           Allow Sentry-CID to set the system time.  Sentry-CID confirms that
  549.           the CID time is accurate by checking current time difference and
  550.           log time difference.  See [CID_DIF_LOW], [CID_DIF_HIGH],
  551.           [MAILER_DIF] and [IGNORE_RESTRICTIONS].  (AVAILABLE ONLY AFTER
  552.           REGISTRATION).
  553.  
  554.      Batch <filename> [DEFAULT is LoadBBS.BAT (DOS) or LoadBBS.CMD (OS/2)]
  555.  
  556.           Path and filename of the bbs batchfile to write (I suggest
  557.           LOADBBS.BAT).  Use different names in different configuration 
  558.           files for different nodes on a multi-node system.  See [LOAD_BBS].
  559.  
  560.      BBSNumber <filename>
  561.  
  562.           Path and filename of the file written by the BBS containing the
  563.           phone number supplied by the user for validation with SCIDV. 
  564.           See [OUTPUT] and [OK_VALIDATION].
  565.  
  566.      CID_Dif_High <time_in_minutes> [DEFAULT is 65]
  567.  
  568.           The *maximum* time difference between the CID time and mailer log
  569.           time before setting the system clock.  Who knows, someone at the
  570.           phone company may decide to play a joke on you.  Set it greater 
  571.           than 60 minutes to allow for daylight savings in your area!
  572.           [AUTOSETTIME], [CID_DIF_LOW], [MAILER_DIF] and        
  573.           [IGNORE_RESTRICTIONS].
  574.  
  575.      CID_Dif_Low <time_in_minutes> [DEFAULT is 0]
  576.  
  577.           The *minimum* time difference between the CID time and mailer log
  578.           time before setting the system clock.  No need to fiddle with
  579.           the system clock if the discrepancy is only a minute or two -
  580.           this may lead to weird looking logfiles in other running
  581.           processes. See [AUTOSETTIME], [CID_DIF_HIGH], [MAILER_DIF] and
  582.           [IGNORE_RESTRICTIONS].
  583.  
  584.      Country_Code <country_code>
  585.  
  586.           Your country's phone code (1 for U.S. and Canada).  See
  587.           [AREA_CODE].
  588.  
  589.      ForceList
  590.  
  591.           Login users found only in the [PHONELIST] file.  See
  592.           [ALLOW_PRIVATE] and [FORCEUSERBBS].
  593.  
  594.      ForceUserBBS
  595.  
  596.           Login users found only in the [USER_BBS] file (disabled if
  597.           [USER_BBS] is not specified).  See [ALLOW_PRIVATE] and 
  598.           [FORCELIST].
  599.  
  600.      Ignore_Restrictions
  601.  
  602.           This tells SCID to NOT verify the CID time, mailer log time or CID
  603.           position in the logfile when logging in a user or setting the 
  604.           time.  This command should never be enabled except for debugging
  605.           purposes.  See [AUTOSETTIME], [CID_DIF_HIGH], [CID_DIF_LOW] and
  606.           [MAILER_DIF].
  607.  
  608.      LastCall_Age <age_in_days> [DEFAULT = disabled]
  609.  
  610.           This is the greatest amount of time (in days) to allow
  611.           auto-password for a user.  When users move or disconnect their    
  612.           phone number, there is a good chance that someone else will get
  613. k          that phone number and be logged in as them when they call your
  614.           board.  A setting of zero disables this feature.  (AVAILABLE
  615.           ONLY AFTER REGISTRATION).
  616.  
  617.      Load_BBS <command_line>
  618.  
  619.           The command line to load your BBS.  For Maximus system use
  620.           something like:
  621.  
  622.                \Max\Max.exe -s%1 -b%2 -p%3 -t%4 -L\Max\Logs\MAX.LOG
  623.  
  624.           For R/A systems use something like:
  625.  
  626.                \ra\ra.exe -b%2 -p%3 -t%4
  627.  
  628.           See [BATCH].
  629.  
  630.      LogLevel <log_level> [DEFAULT is level 2]
  631.  
  632.           This specifies how much information to put in SCID's status log.
  633.           Acceptable values are from 1 (minimal information) to 5 (maximum
  634.           information).  Each log entry is preceded by a character 
  635.           indicating the importance of the entry, in traditional
  636.           BINKLEY/MAXIMUS style.  See [Sentry-CIDLOG].
  637.  
  638.                LogLevel  Characters That Precede Included Entries
  639.           
  640.                     1      ! *
  641.                     2      ! * +
  642.                     3      ! * + :
  643.                     4      ! * + : #
  644.                     5      ! * + : # and blank (no character)
  645.  
  646.  
  647.      MailerLogFile <filename>
  648.  
  649.           Path and filename of the mailer logfile containing the Caller-ID
  650.           information to read.
  651.  
  652.      Mailer_Dif [DEFAULT is 2 minutes]
  653.  
  654.           The time discrepancy allowed between the current time and mailer
  655.           log time.  Occasionally, BinkleyTerm will decide NOT to
  656.           continue writing to it's logfile, and this setting prevents
  657.           logging the same user on over and over when the logtime fails
  658.           to lie within this time.  Increase the time if you have some
  659.           other application which runs between the mailer and Sentry-CID.
  660.  
  661.      Max_Back <number_of_lines> [DEFAULT is 12 lines]
  662.  
  663.           The number of lines from the end of the [MAILERLOGFILE] where the
  664.           CID information must lie for the data to be considered accurate.
  665.           This is in case two CID blocks are received right after
  666.           each other and the phone message of the first is unreadable. 
  667.           Trust me, this HAS happened :)  See [READFROM].
  668.  
  669.      NoSound
  670.  
  671.           Disables the PC speaker in case your computer, like mine, traps
  672.           when the PC speaker is accessed or if you generally dislike
  673.           your computer beeping at you!  Sentry-CID only beeps on warnings 
  674.           (*) and critical errors (!).
  675.  
  676.      NoSysOpLogin
  677.  
  678.           This feature disables [AUTOPASSWORD] for users with an access 
  679.           level of asstsysop or above.  You probably don't want anyone
  680.           other than the asstsysop or sysop themselves logging in from
  681.           their line and accessing your bbs.  (AVAILABLE ONLY AFTER
  682.           REGISTRATION)
  683.  
  684.      Output [DEFAULT is CID.DAT]
  685.  
  686.           Path and filename of a file to write just the phone number to for
  687.           your own use on your bbs or in some other application.
  688.           Unregistered versions of Sentry-CID will have an "UNREGISTERED
  689.           COPY" nag written to the file.   See [BBSNUMBER] and
  690.           [OK_VALIDATION].
  691.  
  692.      PhoneList <filename>
  693.  
  694.           Path and filename of the alias-matching phonelist.  Leave 
  695.           commented out to disable the reading of the [PHONELIST] file. 
  696.           The first phone number following a "+" in the [PHONELIST] file
  697.           will be the [USER_BBS] entry, and all phone numbers following
  698.           it (on that line) will be matched to that number for users who
  699.           call from different phone numbers.  Phone numbers following a
  700.           "-" in the [PHONELIST] are blacklisted numbers and SCID will
  701.           drop carrier on those users (by not loading the BBS).  See
  702.           [FORCELIST].
  703.  
  704.      ReadFrom <byte_location> [DEFAULT = 1500 bytes]
  705.  
  706.           The position from the end of the mailer logfile where SCID will
  707.           begin reading.  This will probably not need to be changed
  708.           unless you have another program which runs before SCID and
  709.           adds to the mailer log file.  See [MAX_BACK].
  710.  
  711.      Registration <key>
  712.  
  713.           This is your key which activates the registered features of
  714.           Sentry-CID.
  715.  
  716.      SentryCIDLog <filename>
  717.  
  718.           Path and filename where SCID will log it's operation.  Leave
  719.           commented out to disable logging.  See [LOGLEVEL].
  720.  
  721.      SysOp <name>
  722.  
  723.           Your name!
  724.  
  725.      User_BBS <filename>
  726.  
  727.           The path and filename of the Maximus USER.BBS file to read.  Leave
  728.           commented out if you do not run a Maximus BBS.  See
  729.           [FORCEUSERBBS].
  730.  
  731.      OK_Validation <filename>
  732.  
  733.           Path and filename of the semaphore file written by Sentry-CID
  734.           Validator to indicate a successful match between the CID phone
  735.           number and the user's supplied phone number to "verify" the
  736.           user by the BBS software.  See [BBSNUMBER] and [OUTPUT].
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.      M A X I M U S    B B S                                                4
  744.  
  745.      _______________________________________________________________________
  746.  
  747.  
  748.  
  749.      I am willing to implement login code for other bbs systems if it is
  750.      possible with the bbs you run.  I have looked into Remote Access and it
  751.      is not possible with that system, but if you think it is with whatever
  752.      software you are running, please let me know.  Callers of other BBS
  753.      software may be able to use the caller validation program outlined in
  754.      section [4.2].
  755.  
  756.      The following examples are VERY scaled-down scripts that I use to
  757.      control my Maximus bbs with caller-id.  They were intended to be simple
  758.      and clear.  If you have a good grip with the MECCA Maximus script
  759.      language, don't be afraid to experiment with what you can do.
  760.  
  761.  
  762.  
  763.      ┌══════════════════┐
  764.      │ [4.1] AUTO-LOGIN │
  765.      └══════════════════┘
  766.  
  767.  
  768.      If [FORCEUSERBBS] is active, only phone numbers found in the [USER_BBS]
  769.      file would be allowed to login.  Otherwise, the caller's phone number
  770.      will be looked up in the BBS userfile and the matching caller will be
  771.      logged in.  Callers with AsstSysOp or SysOp security level, callers
  772.      with multiple accounts at the same phone number, callers who haven't
  773.      called in a while or callers whose CID data fails the time/position
  774.      checks will be prompted for a password.
  775.  
  776.  
  777.  
  778.      ┌══════════════════════════┐
  779.      │ [4.2] ON-LINE VALIDATION │
  780.      └══════════════════════════┘
  781.  
  782.  
  783.      Add the following to the top of your NEWUSER1.MEC file and compile it
  784.      with MECCA.EXE:
  785.  
  786.          ┌───────────────────────────────────────────────────────────┐
  787.          │[clear_stacked]Enable auto-logins? [[Y,n]? [ansopt menu]yn|│
  788.          │[choice]n [keyon]L [ansopt]                                │
  789.          └───────────────────────────────────────────────────────────┘
  790.  
  791.      This will prompt the new user if they would like to enable the
  792.      auto-logins and set the "L" key if they don't want the feature.
  793.  
  794.      Add the following to the top of your NEWUSER2.MEC file and compile it:
  795.  
  796.    ┌──────────────────────────────────────────────────────────────────────┐
  797.    │[/Start]                                                              │
  798.    │NEW USER VALIDATION                                                   │
  799.    │                                                                      │
  800.    │Verifying your number, please wait.                                   │
  801.    │[log]!SCID: Caller attempting verification of %h                      │
  802.    │[delete]VALIDNUM.DAT                                                  │
  803.    │[delete]PHONE.DAT                                                     │
  804.    │[open]PHONE.DAT [write]%h                                             │
  805.    │[open]nul [xtern_dos]\SENTRY\SENTRY.EXE -c\SENTRY\SENTRY.CFG -d       │
  806.    │[ifexist]VALIDNUM.DAT [setpriv Normal]Passed validation![goto Done]   │
  807.    │Your number has failed validation!                                    │
  808.    │                                                                      │
  809.    │Ma Bell shows your call originating from: [link]\SENTRY\CID.DAT       │
  810.    │                                     not: [phone]                     │
  811.    │                                                                      │
  812.    │Please change your phone number, or request validation from the SysOp.│
  813.    │<C>hange number, <l>eave message or <q>uit to bbs [[C,l,q]]? clq|     │
  814.    │[choice]q [goto Done]                                                 │
  815.    │[choice]l [leave_comment goto Done]                                   │
  816.    │[menu_cmd chg_phone]                                                  │
  817.    │[goto Start][/Done]                                                   │
  818.    └──────────────────────────────────────────────────────────────────────┘
  819.  
  820.      You may want to put the above in a separate script file and include an
  821.      option for new users to access it from your main menu in case the
  822.      validation fails the first time around.
  823.  
  824.  
  825.  
  826.      ┌════════════════════════┐
  827.      │ [4.3] AFTER VALIDATION │
  828.      └════════════════════════┘
  829.  
  830.  
  831.      Your users may want to toggle their [AUTOPASSWORD] status themselves. 
  832.      To set that up, entering the following in your CHANGE menu in
  833.      MAX\MENUS.CTL and re-SILT Max:
  834.  
  835.         ┌─────────────────────────────────────────────────────────────┐
  836.         │Display_File   Misc\LogTogle   Limited   "AAuto-Login Toggle"│
  837.         └─────────────────────────────────────────────────────────────┘
  838.  
  839.      and create and compile the file \MAX\MISC\LOGTOGLE.MEC:
  840.  
  841.                   ┌──────────────────────────────────────────┐
  842.                   │[notkey]L AUTO-LOGIN has been toggled OFF.│
  843.                   │[notkey]L [keyon]L [press_enter][quit]    │
  844.                   │AUTO-LOGIN has been toggled ON.           │
  845.                   │[keyoff]L [press_enter][quit]             │
  846.                   └──────────────────────────────────────────┘
  847.  
  848.      You may want to use a similar script as the validation when user's
  849.      attempt to change their phone number from the change menu to test if it
  850.      even needs changing.
  851.  
  852.  
  853.  
  854.      ┌════════════════════════════════════════════┐
  855.      │ [4.4] ENSURING THE NUMBER IS KEPT ACCURATE │
  856.      └════════════════════════════════════════════┘
  857.  
  858.  
  859.      The file LOGO.MEC will not be shown to a user who is logged on by
  860.      Sentry-CID.  You can use this to catch users who start calling from a
  861.      different number (users sharing accounts?).  Place the following in
  862.      your MAX\MISC\LOGO.MEC file:
  863.  
  864.                          ┌───────────────────────────┐
  865.                          │[open]UnKnown.DAT [open]nul│
  866.                          └───────────────────────────┘
  867.  
  868.      and in MAX\MISC\WELCOME.MEC to nag users who login (and not new users):
  869.  
  870.    ┌────────────────────────────────────────────────────────────────────────┐
  871.    │[ifexist]UNKNOWN.DAT [GE Normal] You are calling from an unknown number!│
  872.    │[delete]UNKNOWN.DAT                                                     │
  873.    └────────────────────────────────────────────────────────────────────────┘
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.      M I S C E L L A N E O U S   I N F O R M A T I O N                     5
  881.  
  882.      _______________________________________________________________________
  883.  
  884.  
  885.  
  886.      ┌═══════════════════════┐
  887.      │ [5.1] RELEASE HISTORY │
  888.      └═══════════════════════┘
  889.  
  890.      v1.01  Apr 02/96  Didn't notice this till the mnonth changed.  Fixed
  891.                        a small bug in the way I calculated last_call_date:
  892.  
  893.                        Changed: LastCall = ((*CurrentTm).tm_year - 80) * 512
  894.                                          + (*CurrentTm).tm_yday +38
  895.                                          - MaxUserLastCall;
  896.                        To:      LastCall = ((*CurrentTm).tm_year - 80) * 512
  897.                                          + ((*CurrentTm).tm_mon + 1) * 32
  898.                                          + (*CurrentTm).tm_mday
  899.                                          - MaxLastCall;
  900.  
  901.      v1.00  Apr 01/96  First release of Sentry-CID on April Fool's Day, 
  902.                        because, let's face it, I'm a fool for working
  903.                        on this program when I should have been studying 
  904.                        for finals.
  905.  
  906.  
  907.  
  908.      ┌════════════════════════════════════┐
  909.      │ [5.2] SOFTWARE UPDATES AND SUPPORT │
  910.      └════════════════════════════════════┘
  911.  
  912.  
  913.      I will release new versions of this software package as new ideas hit
  914.      me or as bug reports come in (knock on silicon) :)  New releases will
  915.      be found at the BBS or URL listed below.  Registered users of
  916.      Sentry-CID will receive notices from me when new version are
  917.      available.
  918.  
  919.  
  920.  
  921.      ┌═════════════════════════════┐
  922.      │ [5.3] CONTACTING THE AUTHOR │
  923.      └═════════════════════════════┘
  924.     
  925.  
  926.      I welcome all comments, suggestions and praise.  If you are reporting a
  927.      bug you've found, please also include a snippet of the mailer log which
  928.      caused the error and a copy of SCID's output log in debug mode (run on
  929.      loglevel 5).
  930.  
  931.      Or maybe you'll just want to write me to say hi or offer me a
  932.      high-paying job.  When I'm not hanging out in FIDO.BINKLEY or
  933.      FIDO.OS2PROG, I can be reached at:
  934.  
  935.  
  936.             ┌────────────────────────────────────────────────────────┐
  937.           ┌─┴──────────────────────────────────────────────────────┐ │
  938.           │    E-Mail: 3jhh3@qlink.queensu.ca                      │ │
  939.           │            Jason.Hendriks@cyberspace.crp.kingston.on.ca│ │
  940.           │       URL: http://qlink.queensu.ca/~3jhh3/software.html│ │
  941.           │                                                        │ │
  942.           │  Net-Mail: FidoNet 1:249/117                           │ │
  943.           │       BBS: Cyberspace/2 BBS [613-542-3120]             │ │
  944.           │            Queen's University, Kingston/Ont, CANADA    │ │
  945.           │                                                        │ │
  946.           │Snail-Mail: Jason Hendriks                              │ │
  947.           │            183 Bayne Crescent                          │ │
  948.           │            Cambridge, Ontario                          │ │
  949.           │            N1T 1K4                                     │ │
  950.           │            CANADA                                      ├─┘
  951.           └────────────────────────────────────────────────────────┘
  952.  
  953.  
  954.  
  955.      Made in Canada, eh?
  956.  
  957.  
  958.      ---
  959.  
  960.      &:-) JtG in '96!
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.      Ω
  968.